<!DOCTYPE html><html lang="zh-Hans"><head><meta charset="UTF-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"><meta name="description" content="webpack学习"><meta name="keywords" content="webpack"><meta name="author" content="晟松"><meta name="copyright" content="晟松"><title>webpack学习 | 晟松</title><link rel="shortcut icon" href="/logo.png"><link rel="stylesheet" href="/css/index.css?version=1.9.0"><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/font-awesome@latest/css/font-awesome.min.css?version=1.9.0"><meta name="format-detection" content="telephone=no"><meta http-equiv="x-dns-prefetch-control" content="on"><link rel="dns-prefetch" href="https://cdn.jsdelivr.net"><link rel="dns-prefetch" href="https://hm.baidu.com"><script>var _hmt = _hmt || [];
(function() {
  var hm = document.createElement("script");
  hm.src = "https://hm.baidu.com/hm.js?c34d81d53341febe06a155941e2df16d";
  var s = document.getElementsByTagName("script")[0]; 
  s.parentNode.insertBefore(hm, s);
})();</script><meta http-equiv="Cache-Control" content="no-transform"><meta http-equiv="Cache-Control" content="no-siteapp"><script>var GLOBAL_CONFIG = { 
  root: '/',
  algolia: undefined,
  localSearch: {"path":"search.xml","languages":{"hits_empty":"找不到您查询的内容:${query}"}},
  copy: {
    success: '复制成功',
    error: '复制错误',
    noSupport: '浏览器不支持'
  },
  hexoVersion: '5.4.0'
} </script><meta name="generator" content="Hexo 5.4.0"></head><body><i class="fa fa-arrow-right" id="toggle-sidebar" aria-hidden="true"></i><div id="sidebar" data-display="true"><div class="toggle-sidebar-info text-center"><span data-toggle="切换文章详情">切换站点概览</span><hr></div><div class="sidebar-toc"><div class="sidebar-toc__title">目录</div><div class="sidebar-toc__progress"><span class="progress-notice">你已经读了</span><span class="progress-num">0</span><span class="progress-percentage">%</span><div class="sidebar-toc__progress-bar"></div></div><div class="sidebar-toc__content"><ol class="toc"><li class="toc-item toc-level-1"><a class="toc-link" href="#%E6%80%BB%E4%BD%93%E7%AE%80%E5%8D%95%E4%BB%8B%E7%BB%8D"><span class="toc-number">1.</span> <span class="toc-text">总体简单介绍</span></a><ol class="toc-child"><li class="toc-item toc-level-2"><a class="toc-link" href="#%E5%85%A5%E5%8F%A3-entry"><span class="toc-number">1.1.</span> <span class="toc-text">入口(entry)</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#%E8%BE%93%E5%87%BA-output"><span class="toc-number">1.2.</span> <span class="toc-text">输出(output)</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#loader"><span class="toc-number">1.3.</span> <span class="toc-text">loader</span></a><ol class="toc-child"><li class="toc-item toc-level-6"><a class="toc-link" href="#Warning"><span class="toc-number">1.3.0.0.0.1.</span> <span class="toc-text">Warning</span></a></li><li class="toc-item toc-level-6"><a class="toc-link" href="#Warning-1"><span class="toc-number">1.3.0.0.0.2.</span> <span class="toc-text">Warning</span></a></li><li class="toc-item toc-level-6"><a class="toc-link" href="#Warning-2"><span class="toc-number">1.3.0.0.0.3.</span> <span class="toc-text">Warning</span></a></li></ol></li></ol></li></ol></li></ol></li><li class="toc-item toc-level-2"><a class="toc-link" href="#%E6%8F%92%E4%BB%B6-plugin"><span class="toc-number">1.4.</span> <span class="toc-text">插件(plugin)</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#%E6%A8%A1%E5%BC%8F-mode"><span class="toc-number">1.5.</span> <span class="toc-text">模式(mode)</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#%E6%B5%8F%E8%A7%88%E5%99%A8%E5%85%BC%E5%AE%B9%E6%80%A7-browser-compatibility"><span class="toc-number">1.6.</span> <span class="toc-text">浏览器兼容性(browser compatibility)</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#%E7%8E%AF%E5%A2%83-environment"><span class="toc-number">1.7.</span> <span class="toc-text">环境(environment)</span></a><ol class="toc-child"><li class="toc-item toc-level-3"><a class="toc-link" href="#loader-1"><span class="toc-number">1.7.1.</span> <span class="toc-text">loader</span></a><ol class="toc-child"><li class="toc-item toc-level-5"><a class="toc-link" href="#%E7%A4%BA%E4%BE%8B"><span class="toc-number">1.7.1.0.1.</span> <span class="toc-text">示例</span></a></li><li class="toc-item toc-level-5"><a class="toc-link" href="#%E4%BD%BF%E7%94%A8-loader"><span class="toc-number">1.7.1.0.2.</span> <span class="toc-text">使用 loader</span></a><ol class="toc-child"><li class="toc-item toc-level-6"><a class="toc-link" href="#Configuration"><span class="toc-number">1.7.1.0.2.1.</span> <span class="toc-text">Configuration</span></a></li></ol></li><li class="toc-item toc-level-5"><a class="toc-link" href="#loader-%E7%89%B9%E6%80%A7"><span class="toc-number">1.7.1.0.3.</span> <span class="toc-text">loader 特性</span></a></li><li class="toc-item toc-level-5"><a class="toc-link" href="#%E8%A7%A3%E6%9E%90-loader"><span class="toc-number">1.7.1.0.4.</span> <span class="toc-text">解析 loader</span></a></li></ol></li></ol></li><li class="toc-item toc-level-3"><a class="toc-link" href="#plugin"><span class="toc-number">1.7.2.</span> <span class="toc-text">plugin</span></a><ol class="toc-child"><li class="toc-item toc-level-4"><a class="toc-link" href="#%E5%89%96%E6%9E%90"><span class="toc-number">1.7.2.1.</span> <span class="toc-text">剖析</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#%E7%94%A8%E6%B3%95"><span class="toc-number">1.7.2.2.</span> <span class="toc-text">用法</span></a><ol class="toc-child"><li class="toc-item toc-level-5"><a class="toc-link" href="#%E9%85%8D%E7%BD%AE%E6%96%B9%E5%BC%8F"><span class="toc-number">1.7.2.2.1.</span> <span class="toc-text">配置方式</span></a></li></ol></li></ol></li><li class="toc-item toc-level-3"><a class="toc-link" href="#%E6%A8%A1%E5%9D%97"><span class="toc-number">1.7.3.</span> <span class="toc-text">模块</span></a><ol class="toc-child"><li class="toc-item toc-level-4"><a class="toc-link" href="#%E4%BD%95%E4%B8%BA-webpack-%E6%A8%A1%E5%9D%97"><span class="toc-number">1.7.3.1.</span> <span class="toc-text">何为 webpack 模块</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#%E6%94%AF%E6%8C%81%E7%9A%84%E6%A8%A1%E5%9D%97%E7%B1%BB%E5%9E%8B"><span class="toc-number">1.7.3.2.</span> <span class="toc-text">支持的模块类型</span></a></li></ol></li><li class="toc-item toc-level-3"><a class="toc-link" href="#manifest"><span class="toc-number">1.7.4.</span> <span class="toc-text">manifest</span></a><ol class="toc-child"><li class="toc-item toc-level-4"><a class="toc-link" href="#runtime"><span class="toc-number">1.7.4.1.</span> <span class="toc-text">runtime</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#manifest-1"><span class="toc-number">1.7.4.2.</span> <span class="toc-text">manifest</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#%E9%97%AE%E9%A2%98"><span class="toc-number">1.7.4.3.</span> <span class="toc-text">问题</span></a></li></ol></li><li class="toc-item toc-level-3"><a class="toc-link" href="#%E6%A8%A1%E5%9D%97%E7%83%AD%E6%9B%BF%E6%8D%A2-hot-module-replacement"><span class="toc-number">1.7.5.</span> <span class="toc-text">模块热替换(hot module replacement)</span></a><ol class="toc-child"><li class="toc-item toc-level-4"><a class="toc-link" href="#%E5%9C%A8%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%E4%B8%AD"><span class="toc-number">1.7.5.1.</span> <span class="toc-text">在应用程序中</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#%E5%9C%A8-compiler-%E4%B8%AD"><span class="toc-number">1.7.5.2.</span> <span class="toc-text">在 compiler 中</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#%E5%9C%A8%E6%A8%A1%E5%9D%97%E4%B8%AD"><span class="toc-number">1.7.5.3.</span> <span class="toc-text">在模块中</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#%E5%9C%A8-runtime-%E4%B8%AD"><span class="toc-number">1.7.5.4.</span> <span class="toc-text">在 runtime 中</span></a></li><li class="toc-item toc-level-4"><a class="toc-link" href="#%E7%83%AD%E6%9B%B4%E6%96%B0%E5%8E%9F%E7%90%86"><span class="toc-number">1.7.5.5.</span> <span class="toc-text">热更新原理</span></a></li></ol></li></ol></li><li class="toc-item toc-level-2"><a class="toc-link" href="#chunk"><span class="toc-number">1.8.</span> <span class="toc-text">chunk</span></a></li><li class="toc-item toc-level-2"><a class="toc-link" href="#output-%E8%BE%93%E5%87%BA"><span class="toc-number">1.9.</span> <span class="toc-text">output(输出)</span></a></li></ol></li></ol></div></div><div class="author-info hide"><div class="author-info__avatar text-center"><img src="/img/avatar.png"></div><div class="author-info__name text-center">晟松</div><div class="author-info__description text-center">晟松的博客</div><div class="follow-button"><a target="_blank" rel="noopener" href="https://gitee.com/cheng_song">Gitee</a></div><hr><div class="author-info-articles"><a class="author-info-articles__archives article-meta" href="/archives"><span class="pull-left">文章</span><span class="pull-right">52</span></a><a class="author-info-articles__tags article-meta" href="/tags"><span class="pull-left">标签</span><span class="pull-right">45</span></a></div></div></div><div id="content-outer"><div id="top-container" style="background-image: url(/img/blog-bg.jpg)"><div id="page-header"><span class="pull-left"> <a id="site-name" href="/">晟松</a></span><i class="fa fa-bars toggle-menu pull-right" aria-hidden="true"></i><span class="pull-right menus">   <a class="site-page" href="/">Home</a><a class="site-page" href="/archives">Archives</a><a class="site-page" href="/tags">Tags</a><a class="site-page" href="/categories">Categories</a></span><span class="pull-right"><a class="site-page social-icon search"><i class="fa fa-search"></i><span> 搜索</span></a></span></div><div id="post-info"><div id="post-title">webpack学习</div><div id="post-meta"><time class="post-meta__date"><i class="fa fa-calendar" aria-hidden="true"></i> 2021-05-27</time><div class="post-meta-wordcount"><span>字数总计: </span><span class="word-count">5.5k</span><span class="post-meta__separator">|</span><span>阅读时长: 19 分钟</span></div></div></div></div><div class="layout" id="content-inner"><article id="post"><div class="article-container" id="post-content"><p>主要是因为在面试的时候可能会问到这一方面的问题，还有对一些底层技术的好奇，所以来简单学习一下和记录一下</p>
<p><a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/">官方文档</a></p>
<p>目前已经出到kwebpack5了，但文档目前是更新到4左右，所以可能会有一些版本之间的错误</p>
<h1 id="总体简单介绍"><a href="#总体简单介绍" class="headerlink" title="总体简单介绍"></a>总体简单介绍</h1><p>本质上，<strong>webpack</strong> 是一个用于现代 JavaScript 应用程序的 <em>静态模块打包工具</em>。当 webpack 处理应用程序时，它会在内部从一个或多个入口点构建一个 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/dependency-graph/">依赖图(dependency graph)</a>，然后将你项目中所需的每一个模块组合成一个或多个 <em>bundles</em>，它们均为静态资源，用于展示你的内容。</p>
<p>从 v4.0.0 开始，<strong>webpack 可以不用再引入一个配置文件</strong>来打包项目，然而，它仍然有着 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration">高度可配置性</a>，可以很好满足你的需求。</p>
<p>在开始前你需要先理解一些<strong>核心概念</strong>：</p>
<ul>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/#entry">入口(entry)</a></li>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/#output">输出(output)</a></li>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/#loaders">loader</a></li>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/#plugins">插件(plugin)</a></li>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/#mode">模式(mode)</a></li>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/#browser-compatibility">浏览器兼容性(browser compatibility)</a></li>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/#environment">环境(environment)</a></li>
</ul>
<p>本文档旨在给出这些概念的<strong>高度</strong>概述，同时提供具体概念的详尽相关用例的链接。</p>
<p>为了更好地理解模块打包工具背后的理念，以及在底层它们是如何运作的，请参考以下资源：</p>
<ul>
<li><a target="_blank" rel="noopener" href="https://www.youtube.com/watch?v=UNMkLHzofQI">手动打包一个应用程序</a></li>
<li><a target="_blank" rel="noopener" href="https://www.youtube.com/watch?v=Gc9-7PBqOC8">实时创建一个简单打包工具</a></li>
<li><a target="_blank" rel="noopener" href="https://github.com/ronami/minipack">一个简单打包工具的详细说明</a></li>
</ul>
<h2 id="入口-entry"><a href="#入口-entry" class="headerlink" title="入口(entry)"></a>入口(entry)</h2><p><strong>入口起点(entry point)</strong> 指示 webpack 应该使用哪个模块，来作为构建其内部 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/dependency-graph/">依赖图(dependency graph)</a> 的开始。进入入口起点后，webpack 会找出有哪些模块和库是入口起点（直接和间接）依赖的。</p>
<p>默认值是 <code>./src/index.js</code>，但你可以通过在 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration">webpack configuration</a> 中配置 <code>entry</code> 属性，来指定一个（或多个）不同的入口起点。例如：</p>
<p><strong>webpack.config.js</strong></p>
<figure class="highlight js"><table><tr><td class="code"><pre><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">entry</span>: <span class="string">&#x27;./path/to/my/entry/file.js&#x27;</span>,</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>



<p>在 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/entry-points">入口起点</a> 章节可以了解更多信息。</p>
<h2 id="输出-output"><a href="#输出-output" class="headerlink" title="输出(output)"></a>输出(output)</h2><p><strong>output</strong> 属性告诉 webpack 在哪里输出它所创建的 <em>bundle</em>，以及如何命名这些文件。主要输出文件的默认值是 <code>./dist/main.js</code>，其他生成文件默认放置在 <code>./dist</code> 文件夹中。</p>
<p>你可以通过在配置中指定一个 <code>output</code> 字段，来配置这些处理过程：</p>
<p><strong>webpack.config.js</strong></p>
<figure class="highlight javascript"><table><tr><td class="code"><pre><span class="line"><span class="keyword">const</span> path = <span class="built_in">require</span>(<span class="string">&#x27;path&#x27;</span>);</span><br><span class="line"></span><br><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">entry</span>: <span class="string">&#x27;./path/to/my/entry/file.js&#x27;</span>,</span><br><span class="line">  <span class="attr">output</span>: &#123;</span><br><span class="line">    <span class="attr">path</span>: path.resolve(__dirname, <span class="string">&#x27;dist&#x27;</span>),</span><br><span class="line">    <span class="attr">filename</span>: <span class="string">&#x27;my-first-webpack.bundle.js&#x27;</span>,</span><br><span class="line">  &#125;,</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>

<p>在上面的示例中，我们通过 <code>output.filename</code> 和 <code>output.path</code> 属性，来告诉 webpack bundle 的名称，以及我们想要 bundle 生成(emit)到哪里。可能你想要了解在代码最上面导入的 path 模块是什么，它是一个 <a target="_blank" rel="noopener" href="https://nodejs.org/api/modules.html">Node.js 核心模块</a>，用于操作文件路径。</p>
<p><code>outut</code> 属性还有 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration/output">更多可配置的特性</a>，如果你想要了解更多关于 <code>output</code> 属性的概念，可以通过阅读 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/output">输出章节</a> 来了解更多。</p>
<h2 id="loader"><a href="#loader" class="headerlink" title="loader"></a>loader</h2><p>webpack 只能理解 JavaScript 和 JSON 文件，这是 webpack 开箱可用的自带能力。<strong>loader</strong> 让 webpack 能够去处理其他类型的文件，并将它们转换为有效 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/modules">模块</a>，以供应用程序使用，以及被添加到依赖图中。</p>
<h6 id="Warning"><a href="#Warning" class="headerlink" title="Warning"></a>Warning</h6><p>webpack 的其中一个强大的特性就是能通过 <code>import</code> 导入任何类型的模块（例如 <code>.css</code> 文件），其他打包程序或任务执行器的可能并不支持。我们认为这种语言扩展是很有必要的，因为这可以使开发人员创建出更准确的依赖关系图。</p>
<p>在更高层面，在 webpack 的配置中，<strong>loader</strong> 有两个属性：</p>
<ol>
<li><code>test</code> 属性，识别出哪些文件会被转换。</li>
<li><code>use</code> 属性，定义出在进行转换时，应该使用哪个 loader。</li>
</ol>
<p><strong>webpack.config.js</strong></p>
<figure class="highlight javascript"><table><tr><td class="code"><pre><span class="line"><span class="keyword">const</span> path = <span class="built_in">require</span>(<span class="string">&#x27;path&#x27;</span>);</span><br><span class="line"></span><br><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">output</span>: &#123;</span><br><span class="line">    <span class="attr">filename</span>: <span class="string">&#x27;my-first-webpack.bundle.js&#x27;</span>,</span><br><span class="line">  &#125;,</span><br><span class="line">  <span class="attr">module</span>: &#123;</span><br><span class="line">    <span class="attr">rules</span>: [&#123; <span class="attr">test</span>: <span class="regexp">/\.txt$/</span>, use: <span class="string">&#x27;raw-loader&#x27;</span> &#125;],</span><br><span class="line">  &#125;,</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>

<p>以上配置中，对一个单独的 module 对象定义了 <code>rules</code> 属性，里面包含两个必须属性：<code>test</code> 和 <code>use</code>。这告诉 webpack 编译器(compiler) 如下信息：</p>
<blockquote>
<p>“嘿，webpack 编译器，当你碰到「在 <code>require()</code>/<code>import</code> 语句中被解析为 ‘.txt’ 的路径」时，在你对它打包之前，先 <strong>use(使用)</strong> <code>raw-loader</code> 转换一下。”</p>
</blockquote>
<h6 id="Warning-1"><a href="#Warning-1" class="headerlink" title="Warning"></a>Warning</h6><p>重要的是要记住，在 webpack 配置中定义 rules 时，要定义在 <code>module.rules</code> 而不是 <code>rules</code> 中。为了使你便于理解，如果没有按照正确方式去做，webpack 会给出警告。</p>
<h6 id="Warning-2"><a href="#Warning-2" class="headerlink" title="Warning"></a>Warning</h6><p>请记住，使用正则表达式匹配文件时，你不要为它添加引号。也就是说，<code>/\.txt$/</code> 与 <code>&#39;/\.txt$/&#39;</code> 或 <code>&quot;/\.txt$/&quot;</code> 不一样。前者指示 webpack 匹配任何以 .txt 结尾的文件，后者指示 webpack 匹配具有绝对路径 ‘.txt’ 的单个文件; 这可能不符合你的意图。</p>
<p>在使用 loader 时，可以阅读 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/loaders">loader 章节</a> 查看更深入的自定义配置。</p>
<h2 id="插件-plugin"><a href="#插件-plugin" class="headerlink" title="插件(plugin)"></a>插件(plugin)</h2><p>loader 用于转换某些类型的模块，而插件则可以用于执行范围更广的任务。包括：打包优化，资源管理，注入环境变量。</p>
<p>查看 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/api/plugins">插件接口(plugin interface)</a>，学习如何使用它来扩展 webpack 能力。</p>
<p>想要使用一个插件，你只需要 <code>require()</code> 它，然后把它添加到 <code>plugins</code> 数组中。多数插件可以通过选项(option)自定义。你也可以在一个配置文件中因为不同目的而多次使用同一个插件，这时需要通过使用 <code>new</code> 操作符来创建一个插件实例。</p>
<p><strong>webpack.config.js</strong></p>
<figure class="highlight javascript"><table><tr><td class="code"><pre><span class="line"><span class="keyword">const</span> HtmlWebpackPlugin = <span class="built_in">require</span>(<span class="string">&#x27;html-webpack-plugin&#x27;</span>);</span><br><span class="line"><span class="keyword">const</span> webpack = <span class="built_in">require</span>(<span class="string">&#x27;webpack&#x27;</span>); <span class="comment">// 用于访问内置插件</span></span><br><span class="line"></span><br><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">module</span>: &#123;</span><br><span class="line">    <span class="attr">rules</span>: [&#123; <span class="attr">test</span>: <span class="regexp">/\.txt$/</span>, use: <span class="string">&#x27;raw-loader&#x27;</span> &#125;],</span><br><span class="line">  &#125;,</span><br><span class="line">  <span class="attr">plugins</span>: [<span class="keyword">new</span> HtmlWebpackPlugin(&#123; <span class="attr">template</span>: <span class="string">&#x27;./src/index.html&#x27;</span> &#125;)],</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>

<p>在上面的示例中，<code>html-webpack-plugin</code> 为应用程序生成一个 HTML 文件，并自动将生成的所有 bundle 注入到此文件中。</p>
<p>webpack 提供许多开箱可用的插件！查阅 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/plugins">插件列表</a> 获取更多。</p>
<p>在 webpack 配置中使用插件是简单直接的。然而，也有很多值得我们进一步探讨的用例。<a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/plugins">查看这里了解更多</a>。</p>
<h2 id="模式-mode"><a href="#模式-mode" class="headerlink" title="模式(mode)"></a>模式(mode)</h2><p>通过选择 <code>development</code>, <code>production</code> 或 <code>none</code> 之中的一个，来设置 <code>mode</code> 参数，你可以启用 webpack 内置在相应环境下的优化。其默认值为 <code>production</code>。</p>
<figure class="highlight javascript"><table><tr><td class="code"><pre><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">mode</span>: <span class="string">&#x27;production&#x27;</span>,</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>

<p>想要了解更多，请查阅 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration/mode">mode 配置</a>，这里有具体每个值相应的优化行为。</p>
<h2 id="浏览器兼容性-browser-compatibility"><a href="#浏览器兼容性-browser-compatibility" class="headerlink" title="浏览器兼容性(browser compatibility)"></a>浏览器兼容性(browser compatibility)</h2><p>Webpack 支持所有符合 <a target="_blank" rel="noopener" href="https://kangax.github.io/compat-table/es5/">ES5 标准</a> 的浏览器（不支持 IE8 及以下版本）。webpack 的 <code>import()</code> 和 <code>require.ensure()</code> 需要 <code>Promise</code>。如果你想要支持旧版本浏览器，在使用这些表达式之前，还需要 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/guides/shimming/">提前加载 polyfill</a>。</p>
<h2 id="环境-environment"><a href="#环境-environment" class="headerlink" title="环境(environment)"></a>环境(environment)</h2><p>Webpack 5 运行于 Node.js v10.13.0+ 的版本。</p>
<p>然后后面就是对里面的每一个大的模块进行一个简单的阅读和了解，然后如果后面需要的话就去里面查一下，重点应该放在loader和plugin里面进行写了</p>
<h3 id="loader-1"><a href="#loader-1" class="headerlink" title="loader"></a>loader</h3><p>loader 用于对模块的源代码进行转换。loader 可以使你在 <code>import</code> 或 “load(加载)” 模块时预处理文件。因此，loader 类似于其他构建工具中“任务(task)”，并提供了处理前端构建步骤的得力方式。loader 可以将文件从不同的语言（如 TypeScript）转换为 JavaScript 或将内联图像转换为 data URL。loader 甚至允许你直接在 JavaScript 模块中 <code>import</code> CSS 文件！</p>
<h5 id="示例"><a href="#示例" class="headerlink" title="示例"></a>示例</h5><p>例如，你可以使用 loader 告诉 webpack 加载 CSS 文件，或者将 TypeScript 转为 JavaScript。为此，首先安装相对应的 loader：</p>
<figure class="highlight bash"><table><tr><td class="code"><pre><span class="line">npm install --save-dev css-loader ts-loader</span><br></pre></td></tr></table></figure>

<p>然后指示 webpack 对每个 <code>.css</code> 使用 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/loaders/css-loader"><code>css-loader</code></a>，以及对所有 <code>.ts</code> 文件使用 <a target="_blank" rel="noopener" href="https://github.com/TypeStrong/ts-loader"><code>ts-loader</code></a>：</p>
<p><strong>webpack.config.js</strong></p>
<figure class="highlight js"><table><tr><td class="code"><pre><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">module</span>: &#123;</span><br><span class="line">    <span class="attr">rules</span>: [</span><br><span class="line">      &#123; <span class="attr">test</span>: <span class="regexp">/\.css$/</span>, use: <span class="string">&#x27;css-loader&#x27;</span> &#125;,</span><br><span class="line">      &#123; <span class="attr">test</span>: <span class="regexp">/\.ts$/</span>, use: <span class="string">&#x27;ts-loader&#x27;</span> &#125;,</span><br><span class="line">    ],</span><br><span class="line">  &#125;,</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>

<h5 id="使用-loader"><a href="#使用-loader" class="headerlink" title="使用 loader"></a>使用 loader</h5><h6 id="Configuration"><a href="#Configuration" class="headerlink" title="Configuration"></a>Configuration</h6><p><a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration/module/#modulerules"><code>module.rules</code></a> 允许你在 webpack 配置中指定多个 loader。 这种方式是展示 loader 的一种简明方式，并且有助于使代码变得简洁和易于维护。同时让你对各个 loader 有个全局概览：</p>
<p>loader 从右到左（或从下到上）地取值(evaluate)/执行(execute)。在下面的示例中，从 sass-loader 开始执行，然后继续执行 css-loader，最后以 style-loader 为结束。查看 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/loaders/#loader-features">loader 功能</a> 章节，了解有关 loader 顺序的更多信息。</p>
<figure class="highlight js"><table><tr><td class="code"><pre><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">module</span>: &#123;</span><br><span class="line">    <span class="attr">rules</span>: [</span><br><span class="line">      &#123;</span><br><span class="line">        <span class="attr">test</span>: <span class="regexp">/\.css$/</span>,</span><br><span class="line">        use: [</span><br><span class="line">          <span class="comment">// [style-loader](/loaders/style-loader)</span></span><br><span class="line">          &#123; <span class="attr">loader</span>: <span class="string">&#x27;style-loader&#x27;</span> &#125;,</span><br><span class="line">          <span class="comment">// [css-loader](/loaders/css-loader)</span></span><br><span class="line">          &#123;</span><br><span class="line">            <span class="attr">loader</span>: <span class="string">&#x27;css-loader&#x27;</span>,</span><br><span class="line">            <span class="attr">options</span>: &#123;</span><br><span class="line">              <span class="attr">modules</span>: <span class="literal">true</span></span><br><span class="line">            &#125;</span><br><span class="line">          &#125;,</span><br><span class="line">          <span class="comment">// [sass-loader](/loaders/sass-loader)</span></span><br><span class="line">          &#123; <span class="attr">loader</span>: <span class="string">&#x27;sass-loader&#x27;</span> &#125;</span><br><span class="line">        ]</span><br><span class="line">      &#125;</span><br><span class="line">    ]</span><br><span class="line">  &#125;</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>

<h5 id="loader-特性"><a href="#loader-特性" class="headerlink" title="loader 特性"></a>loader 特性</h5><ul>
<li>loader 支持<strong>链式调用</strong>。链中的每个 loader 会将转换应用在已处理过的资源上。一组链式的 loader 将按照相反的顺序执行。链中的第一个 loader 将其结果（也就是应用过转换后的资源）<strong>传递给下一个 loader</strong>，依此类推。最后，<strong>链中的最后一个 loader，返回 webpack 所期望的 JavaScript。</strong></li>
<li>loader 可以是同步的，也可以是异步的。</li>
<li>loader 运行在 Node.js 中，并且能够执行任何操作。</li>
<li>loader 可以通过 <code>options</code> 对象配置（仍然支持使用 <code>query</code> 参数来设置选项，但是这种方式已被废弃）。</li>
<li>除了常见的通过 <code>package.json</code> 的 <code>main</code> 来将一个 npm 模块导出为 loader，还可以在 module.rules 中使用 <code>loader</code> 字段直接引用一个模块。</li>
<li>插件(plugin)可以为 loader 带来更多特性。</li>
<li>loader 能够产生额外的任意文件。</li>
</ul>
<p>可以通过 loader 的预处理函数，为 JavaScript 生态系统提供更多能力。用户现在可以更加灵活地引入细粒度逻辑，例如：压缩、打包、语言转译（或编译）和 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/loaders">更多其他特性</a>。</p>
<h5 id="解析-loader"><a href="#解析-loader" class="headerlink" title="解析 loader"></a>解析 loader</h5><p>loader 遵循标准 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/module-resolution/">模块解析</a> 规则。多数情况下，loader 将从 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/module-resolution/#module-paths">模块路径</a> 加载（通常是从 <code>npm install</code>, <code>node_modules</code> 进行加载）。</p>
<p>我们预期 loader 模块导出为一个函数，并且编写为 Node.js 兼容的 JavaScript。通常使用 npm 进行管理 loader，但是也可以将应用程序中的文件作为自定义 loader。按照约定，loader 通常被命名为 <code>xxx-loader</code>（例如 <code>json-loader</code>）。更多详细信息，请查看 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/contribute/writing-a-loader/">编写一个 loader</a>。</p>
<h3 id="plugin"><a href="#plugin" class="headerlink" title="plugin"></a>plugin</h3><p><strong>插件</strong> 是 webpack 的 <a target="_blank" rel="noopener" href="https://github.com/webpack/tapable">支柱</a> 功能。Webpack 自身也是构建于你在 webpack 配置中用到的 <strong>相同的插件系统</strong> 之上！</p>
<p>插件目的在于解决 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/loaders">loader</a> 无法实现的<strong>其他事</strong>。Webpack 提供很多开箱即用的 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/plugins/">插件</a>。</p>
<h4 id="剖析"><a href="#剖析" class="headerlink" title="剖析"></a>剖析</h4><p>webpack <strong>插件</strong>是一个具有 <a target="_blank" rel="noopener" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function/apply"><code>apply</code></a> 方法的 JavaScript 对象。<code>apply</code> 方法会被 webpack compiler 调用，并且在 <strong>整个</strong> 编译生命周期都可以访问 compiler 对象。</p>
<p><strong>ConsoleLogOnBuildWebpackPlugin.js</strong></p>
<figure class="highlight javascript"><table><tr><td class="code"><pre><span class="line"><span class="keyword">const</span> pluginName = <span class="string">&#x27;ConsoleLogOnBuildWebpackPlugin&#x27;</span>;</span><br><span class="line"></span><br><span class="line"><span class="class"><span class="keyword">class</span> <span class="title">ConsoleLogOnBuildWebpackPlugin</span> </span>&#123;</span><br><span class="line">  <span class="function"><span class="title">apply</span>(<span class="params">compiler</span>)</span> &#123;</span><br><span class="line">    compiler.hooks.run.tap(pluginName, <span class="function">(<span class="params">compilation</span>) =&gt;</span> &#123;</span><br><span class="line">      <span class="built_in">console</span>.log(<span class="string">&#x27;webpack 构建正在启动！&#x27;</span>);</span><br><span class="line">    &#125;);</span><br><span class="line">  &#125;</span><br><span class="line">&#125;</span><br><span class="line"></span><br><span class="line"><span class="built_in">module</span>.exports = ConsoleLogOnBuildWebpackPlugin;</span><br></pre></td></tr></table></figure>

<p>compiler hook 的 tap 方法的第一个参数，应该是驼峰式命名的插件名称。建议为此使用一个常量，以便它可以在所有 hook 中重复使用。</p>
<h4 id="用法"><a href="#用法" class="headerlink" title="用法"></a>用法</h4><p>由于<strong>插件</strong>可以携带参数/选项，你必须在 webpack 配置中，向 <code>plugins</code> 属性传入一个 <code>new</code> 实例。</p>
<p>取决于你的 webpack 用法，对应有多种使用插件的方式。</p>
<h5 id="配置方式"><a href="#配置方式" class="headerlink" title="配置方式"></a>配置方式</h5><p><strong>webpack.config.js</strong></p>
<figure class="highlight javascript"><table><tr><td class="code"><pre><span class="line"><span class="keyword">const</span> HtmlWebpackPlugin = <span class="built_in">require</span>(<span class="string">&#x27;html-webpack-plugin&#x27;</span>);</span><br><span class="line"><span class="keyword">const</span> webpack = <span class="built_in">require</span>(<span class="string">&#x27;webpack&#x27;</span>); <span class="comment">// 访问内置的插件</span></span><br><span class="line"><span class="keyword">const</span> path = <span class="built_in">require</span>(<span class="string">&#x27;path&#x27;</span>);</span><br><span class="line"></span><br><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">entry</span>: <span class="string">&#x27;./path/to/my/entry/file.js&#x27;</span>,</span><br><span class="line">  <span class="attr">output</span>: &#123;</span><br><span class="line">    <span class="attr">filename</span>: <span class="string">&#x27;my-first-webpack.bundle.js&#x27;</span>,</span><br><span class="line">    <span class="attr">path</span>: path.resolve(__dirname, <span class="string">&#x27;dist&#x27;</span>),</span><br><span class="line">  &#125;,</span><br><span class="line">  <span class="attr">module</span>: &#123;</span><br><span class="line">    <span class="attr">rules</span>: [</span><br><span class="line">      &#123;</span><br><span class="line">        <span class="attr">test</span>: <span class="regexp">/\.(js|jsx)$/</span>,</span><br><span class="line">        use: <span class="string">&#x27;babel-loader&#x27;</span>,</span><br><span class="line">      &#125;,</span><br><span class="line">    ],</span><br><span class="line">  &#125;,</span><br><span class="line">  <span class="attr">plugins</span>: [</span><br><span class="line">    <span class="keyword">new</span> webpack.ProgressPlugin(),</span><br><span class="line">    <span class="keyword">new</span> HtmlWebpackPlugin(&#123; <span class="attr">template</span>: <span class="string">&#x27;./src/index.html&#x27;</span> &#125;),</span><br><span class="line">  ],</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>

<p><code>ProgressPlugin</code> 用于自定义编译过程中的进度报告，<code>HtmlWebpackPlugin</code> 将生成一个 HTML 文件，并在其中使用 <code>script</code> 引入一个名为 <code>my-first-webpack.bundle.js</code> 的 JS 文件。</p>
<h3 id="模块"><a href="#模块" class="headerlink" title="模块"></a>模块</h3><h4 id="何为-webpack-模块"><a href="#何为-webpack-模块" class="headerlink" title="何为 webpack 模块"></a>何为 webpack 模块</h4><p>与 <a target="_blank" rel="noopener" href="https://nodejs.org/api/modules.html">Node.js 模块</a>相比，webpack <em>模块</em> 能以各种方式表达它们的依赖关系。下面是一些示例：</p>
<ul>
<li><a target="_blank" rel="noopener" href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/import">ES2015 <code>import</code></a> 语句</li>
<li><a target="_blank" rel="noopener" href="http://www.commonjs.org/specs/modules/1.0/">CommonJS</a> <code>require()</code> 语句</li>
<li><a target="_blank" rel="noopener" href="https://github.com/amdjs/amdjs-api/blob/master/AMD.md">AMD</a> <code>define</code> 和 <code>require</code> 语句</li>
<li>css/sass/less 文件中的 <a target="_blank" rel="noopener" href="https://developer.mozilla.org/en-US/docs/Web/CSS/@import"><code>@import</code> 语句</a>。</li>
<li>stylesheet <code>url(...)</code> 或者 HTML <code>&lt;img src=...&gt;</code> 文件中的图片链接。</li>
</ul>
<h4 id="支持的模块类型"><a href="#支持的模块类型" class="headerlink" title="支持的模块类型"></a>支持的模块类型</h4><p>Webpack 天生支持如下模块类型：</p>
<ul>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/guides/ecma-script-modules">ECMAScript 模块</a></li>
<li>CommonJS 模块</li>
<li>AMD 模块</li>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/guides/asset-modules">Assets</a></li>
<li>WebAssembly 模块</li>
</ul>
<p>通过 <strong>loader</strong> 可以使 webpack 支持多种语言和预处理器语法编写的模块。<strong>loader</strong> 向 webpack 描述了如何处理非原生<em>模块</em>，并将相关<strong>依赖</strong>引入到你的 <strong>bundles</strong>中。 webpack 社区已经为各种流行的语言和预处理器创建了 <em>loader</em>，其中包括：</p>
<ul>
<li><a target="_blank" rel="noopener" href="http://coffeescript.org/">CoffeeScript</a></li>
<li><a target="_blank" rel="noopener" href="https://www.typescriptlang.org/">TypeScript</a></li>
<li><a target="_blank" rel="noopener" href="https://babeljs.io/">ESNext (Babel)</a></li>
<li><a target="_blank" rel="noopener" href="http://sass-lang.com/">Sass</a></li>
<li><a target="_blank" rel="noopener" href="http://lesscss.org/">Less</a></li>
<li><a target="_blank" rel="noopener" href="http://stylus-lang.com/">Stylus</a></li>
<li><a target="_blank" rel="noopener" href="https://elm-lang.org/">Elm</a></li>
</ul>
<p>当然还有更多！总得来说，webpack 提供了可定制，强大且丰富的 API，允许在 <strong>任何技术栈</strong> 中使用，同时支持在开发、测试和生产环境的工作流中做到 <strong>无侵入性</strong>。</p>
<p>关于 loader 的相关信息，请参考 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/loaders"><strong>loader 列表</strong></a> 或 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/api/loaders"><strong>自定义 loader</strong></a>。</p>
<h3 id="manifest"><a href="#manifest" class="headerlink" title="manifest"></a>manifest</h3><p>在使用 webpack 构建的典型应用程序或站点中，有三种主要的代码类型：</p>
<ol>
<li>你或你的团队编写的源码。</li>
<li>你的源码会依赖的任何第三方的 library 或 “vendor” 代码。</li>
<li>webpack 的 runtime 和 <strong>manifest</strong>，管理所有模块的交互。</li>
</ol>
<p>本文将重点介绍这三个部分中的最后部分：runtime 和 manifest，特别是 manifest。</p>
<h4 id="runtime"><a href="#runtime" class="headerlink" title="runtime"></a>runtime</h4><p>runtime，以及伴随的 manifest 数据，主要是指：在浏览器运行过程中，webpack 用来连接模块化应用程序所需的所有代码。它包含：在模块交互时，连接模块所需的加载和解析逻辑。包括：已经加载到浏览器中的连接模块逻辑，以及尚未加载模块的延迟加载逻辑。</p>
<h4 id="manifest-1"><a href="#manifest-1" class="headerlink" title="manifest"></a>manifest</h4><p>一旦你的应用在浏览器中以 <code>index.html</code> 文件的形式被打开，一些 bundle 和应用需要的各种资源都需要用某种方式被加载与链接起来。在经过打包、压缩、为延迟加载而拆分为细小的 chunk 这些 webpack <a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration/optimization/"><code>优化</code></a> 之后，你精心安排的 <code>/src</code> 目录的文件结构都已经不再存在。所以 webpack 如何管理所有所需模块之间的交互呢？这就是 manifest 数据用途的由来……</p>
<p>当 compiler 开始执行、解析和映射应用程序时，它会保留所有模块的详细要点。这个数据集合称为 “manifest”，当完成打包并发送到浏览器时，runtime 会通过 manifest 来解析和加载模块。无论你选择哪种 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/api/module-methods">模块语法</a>，那些 <code>import</code> 或 <code>require</code> 语句现在都已经转换为 <code>__webpack_require__</code> 方法，此方法指向模块标识符(module identifier)。通过使用 manifest 中的数据，runtime 将能够检索这些标识符，找出每个标识符背后对应的模块。</p>
<h4 id="问题"><a href="#问题" class="headerlink" title="问题"></a>问题</h4><p>所以，现在你应该对 webpack 在幕后工作有一点了解。“但是，这对我有什么影响呢？”，你可能会问。答案是大多数情况下没有。runtime 做完成这些工作：<strong>一旦你的应用程序加载到浏览器中，使用 manifest，然后所有内容将展现出魔幻般运行结果。然而，如果你决定通过使用浏览器缓存来改善项目的性能，理解这一过程将突然变得极为重要</strong>。</p>
<p>通过使用内容散列(content hash)作为 bundle 文件的名称，这样在文件内容修改时，会计算出新的 hash，浏览器会使用新的名称加载文件，从而使缓存无效。一旦你开始这样做，你会立即注意到一些有趣的行为。即使某些内容明显没有修改，某些 hash 还是会改变。这是因为，注入的 runtime 和 manifest 在每次构建后都会发生变化。</p>
<p>查看 <em>管理输出</em> 指南的 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/guides/output-management/#the-manifest">manifest 部分</a>，了解如何提取 manifest，并阅读下面的指南，以了解更多长效缓存错综复杂之处</p>
<h3 id="模块热替换-hot-module-replacement"><a href="#模块热替换-hot-module-replacement" class="headerlink" title="模块热替换(hot module replacement)"></a>模块热替换(hot module replacement)</h3><p>模块热替换(HMR - hot module replacement)功能会在应用程序运行过程中，替换、添加或删除 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/modules/">模块</a>，而无需重新加载整个页面。主要是通过以下几种方式，来显著加快开发速度：</p>
<ul>
<li>保留在完全重新加载页面期间丢失的应用程序状态。</li>
<li>只更新变更内容，以节省宝贵的开发时间。</li>
<li>在源代码中 CSS/JS 产生修改时，会立刻在浏览器中进行更新，这几乎相当于在浏览器 devtools 直接更改样式</li>
</ul>
<h4 id="在应用程序中"><a href="#在应用程序中" class="headerlink" title="在应用程序中"></a>在应用程序中</h4><p>通过以下步骤，可以做到在应用程序中置换(swap in and out)模块：</p>
<ol>
<li>应用程序要求 HMR runtime 检查更新。</li>
<li>HMR runtime 异步地下载更新，然后通知应用程序。</li>
<li>应用程序要求 HMR runtime 应用更新。</li>
<li>HMR runtime 同步地应用更新。</li>
</ol>
<p>你可以设置 HMR，以使此进程自动触发更新，或者你可以选择要求在用户交互时进行更新。</p>
<h4 id="在-compiler-中"><a href="#在-compiler-中" class="headerlink" title="在 compiler 中"></a>在 compiler 中</h4><p>除了普通资源，compiler 需要发出 “update”，将之前的版本更新到新的版本。”update” 由两部分组成：</p>
<ol>
<li>更新后的 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/concepts/manifest">manifest</a> (JSON)</li>
<li>一个或多个 updated chunk (JavaScript)</li>
</ol>
<p><strong>manifest 包括新的 compilation hash 和所有的 updated chunk 列表</strong>。每个 chunk 都包含着全部更新模块的最新代码（或一个 flag 用于表明此模块需要被移除）。</p>
<p>compiler 会确保在这些构建之间的模块 ID 和 chunk ID 保持一致。通常将这些 ID 存储在内存中（例如，使用 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration/dev-server/">webpack-dev-server</a> 时），但是也可能会将它们存储在一个 JSON 文件中。</p>
<h4 id="在模块中"><a href="#在模块中" class="headerlink" title="在模块中"></a>在模块中</h4><p>HMR 是可选功能，只会影响包含 HMR 代码的模块。举个例子，通过 <a target="_blank" rel="noopener" href="https://github.com/webpack-contrib/style-loader"><code>style-loader</code></a> 为 style 追加补丁。为了运行追加补丁，<code>style-loader</code> 实现了 HMR 接口；当它通过 HMR 接收到更新，它会使用新的样式替换旧的样式。</p>
<p>类似的，当在一个模块中实现了 HMR 接口，你可以描述出当模块被更新后发生了什么。然而在多数情况下，不需要在每个模块中强行写入 HMR 代码。如果一个模块没有 HMR 处理函数，更新就会冒泡(bubble up)。这意味着某个单独处理函数能够更新整个模块树。如果在模块树的一个单独模块被更新，那么整组依赖模块都会被重新加载。</p>
<p>有关 <code>module.hot</code> 接口的详细信息，请查看 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/api/hot-module-replacement">HMR API 页面</a>。</p>
<h4 id="在-runtime-中"><a href="#在-runtime-中" class="headerlink" title="在 runtime 中"></a>在 runtime 中</h4><p>这件事情比较有技术性……如果你对其内部不感兴趣，可以随时跳到 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/api/hot-module-replacement">HMR API 页面</a> 或 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/guides/hot-module-replacement">HMR 指南</a>。</p>
<p>对于模块系统运行时(module system runtime)，会发出额外代码，来跟踪模块 <code>parents</code> 和 <code>children</code> 关系。在管理方面，runtime 支持两个方法 <code>check</code> 和 <code>apply</code>。</p>
<p><code>check</code> 方法，发送一个 HTTP 请求来更新 manifest。如果请求失败，说明没有可用更新。如果请求成功，会将 updated chunk 列表与当前的 loaded chunk 列表进行比较。每个 loaded chunk 都会下载相应的 updated chunk。当所有更新 chunk 完成下载，runtime 就会切换到 <code>ready</code> 状态。</p>
<p><code>apply</code> 方法，<strong>将所有 updated module 标记为无效</strong>。对于每个无效 module，都需要在模块中有一个 <strong>update handler</strong>，或者在此模块的父级模块中有 update handler。否则，会进行无效标记<strong>冒泡</strong>，并且父级也会被标记为无效。继续每个冒泡，直到到达应用程序入口起点，或者到达带有 update handler 的 module（以最先到达为准，冒泡停止）。如果它从入口起点开始冒泡，则此过程失败。</p>
<p>之后，所有无效 module 都会被（通过 dispose handler）处理和解除加载。然后更新当前 hash，并且调用所有 <code>accept</code> handler。runtime 切换回 <code>idle</code>（闲置） 状态，一切照常继续。</p>
<h4 id="热更新原理"><a href="#热更新原理" class="headerlink" title="热更新原理"></a><a target="_blank" rel="noopener" href="https://www.cnblogs.com/magicg/p/13679273.html">热更新原理</a></h4><h2 id="chunk"><a href="#chunk" class="headerlink" title="chunk"></a>chunk</h2><p>chunk 有两种形式：</p>
<ul>
<li><code>initial(初始化)</code> 是入口起点的 main chunk。此 chunk 包含为入口起点指定的所有模块及其依赖项。</li>
<li><code>non-initial</code> 是可以延迟加载的块。可能会出现在使用 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/guides/code-splitting/#dynamic-imports">动态导入(dynamic imports)</a> 或者 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/plugins/split-chunks-plugin/">SplitChunksPlugin</a> 时。</li>
</ul>
<p>每个 chunk 都有对应的 **asset(资源)**。资源，是指输出文件（即打包结果）。</p>
<p><strong>webpack.config.js</strong></p>
<figure class="highlight js"><table><tr><td class="code"><pre><span class="line"><span class="built_in">module</span>.exports = &#123;</span><br><span class="line">  <span class="attr">entry</span>: <span class="string">&#x27;./src/index.jsx&#x27;</span>,</span><br><span class="line">&#125;;</span><br></pre></td></tr></table></figure>

<p><strong>./src/index.jsx</strong></p>
<figure class="highlight js"><table><tr><td class="code"><pre><span class="line"><span class="keyword">import</span> React <span class="keyword">from</span> <span class="string">&#x27;react&#x27;</span>;</span><br><span class="line"><span class="keyword">import</span> ReactDOM <span class="keyword">from</span> <span class="string">&#x27;react-dom&#x27;</span>;</span><br><span class="line"></span><br><span class="line"><span class="keyword">import</span>(<span class="string">&#x27;./app.jsx&#x27;</span>).then(<span class="function">(<span class="params">App</span>) =&gt;</span> &#123;</span><br><span class="line">  ReactDOM.render(<span class="xml"><span class="tag">&lt;<span class="name">App</span> /&gt;</span></span>, root);</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure>

<p>这会创建出一个名为 <code>main</code> 的 initial chunk。其中包含：</p>
<ul>
<li><code>./src/index.jsx</code></li>
<li><code>react</code></li>
<li><code>react-dom</code></li>
</ul>
<p>以及除 <code>./app.jsx</code> 外的所有依赖</p>
<p>然后会为 <code>./app.jsx</code> 创建 non-initial chunk，这是因为 <code>./app.jsx</code> 是动态导入的。</p>
<p><strong>Output:</strong></p>
<ul>
<li><code>/dist/main.js</code> - 一个 <code>initial</code> chunk</li>
<li><code>/dist/394.js</code> - <code>non-initial</code> chunk</li>
</ul>
<p>默认情况下，这些 <code>non-initial</code> chunk 没有名称，因此会使用唯一 ID 来替代名称。 在使用动态导入时，我们可以通过使用 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/api/module-methods/#magic-comments">magic comment(魔术注释)</a> 来显式指定 chunk 名称：</p>
<figure class="highlight js"><table><tr><td class="code"><pre><span class="line"><span class="keyword">import</span>(</span><br><span class="line">  <span class="comment">/* webpackChunkName: &quot;app&quot; */</span></span><br><span class="line">  <span class="string">&#x27;./app.jsx&#x27;</span></span><br><span class="line">).then(<span class="function">(<span class="params">App</span>) =&gt;</span> &#123;</span><br><span class="line">  ReactDOM.render(<span class="xml"><span class="tag">&lt;<span class="name">App</span> /&gt;</span></span>, root);</span><br><span class="line">&#125;);</span><br></pre></td></tr></table></figure>

<p><strong>Output:</strong></p>
<ul>
<li><code>/dist/main.js</code> - 一个 <code>initial</code> chunk</li>
<li><code>/dist/app.js</code> - <code>non-initial</code> chunk</li>
</ul>
<h2 id="output-输出"><a href="#output-输出" class="headerlink" title="output(输出)"></a>output(输出)</h2><p>输出文件的名称会受配置中的两个字段的影响：</p>
<ul>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration/output/#outputfilename"><code>output.filename</code></a> - 用于 <code>initial</code> chunk 文件</li>
<li><a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration/output/#outputchunkfilename"><code>output.chunkFilename</code></a> - 用于 <code>non-initial</code> chunk 文件</li>
<li>在某些情况下，使用 <code>initial</code> 和 <code>non-initial</code> 的 chunk 时，可以使用 <code>output.filename</code>。</li>
</ul>
<p>这些字段中会有一些 <a target="_blank" rel="noopener" href="https://webpack.docschina.org/configuration/output/#template-strings">占位符</a>。常用的占位符如下：</p>
<ul>
<li><code>[id]</code> - chunk id（例如 <code>[id].js</code> -&gt; <code>485.js</code>）</li>
<li><code>[name]</code> - chunk name（例如 <code>[name].js</code> -&gt; <code>app.js</code>）。如果 chunk 没有名称，则会使用其 id 作为名称</li>
<li><code>[contenthash]</code> - 输出文件内容的 md4-hash（例如 <code>[contenthash].js</code> -&gt; <code>4ea6ff1de66c537eb9b2.js</code>）</li>
</ul>
<p>然后后面就是一些api，配置，loader这些了，后面简单看一下就是了，不太好记</p>
<p>后面比较核心的就是它的指南了，通过这个指南能知道一些大致的东西，有什么用，又如何用的，简单看一遍</p>
</div></article><div class="post-copyright"><div class="post-copyright__author"><span class="post-copyright-meta">文章作者: </span><span class="post-copyright-info"><a href="mailto:undefined">晟松</a></span></div><div class="post-copyright__type"><span class="post-copyright-meta">文章链接: </span><span class="post-copyright-info"><a href="https://chengsong.info/2021/05/27/webpack学习/">https://chengsong.info/2021/05/27/webpack学习/</a></span></div><div class="post-copyright__notice"><span class="post-copyright-meta">版权声明: </span><span class="post-copyright-info">本博客所有文章除特别声明外，均采用 <a target="_blank" rel="noopener" href="https://creativecommons.org/licenses/by-nc-sa/4.0/">CC BY-NC-SA 4.0</a> 许可协议。转载请注明来自 <a href="https://chengsong.info">晟松</a>！</span></div></div><div class="post-meta__tag-list"><a class="post-meta__tags" href="/tags/webpack/">webpack</a></div><nav id="pagination"><div class="prev-post pull-left"><a href="/2021/06/05/%E5%B5%8C%E5%85%A5%E5%BC%8F%E5%A4%8D%E4%B9%A0/"><i class="fa fa-chevron-left">  </i><span>嵌入式复习</span></a></div><div class="next-post pull-right"><a href="/2021/05/16/%E5%8C%BA%E5%9D%97%E9%93%BE%E4%B8%AD%E5%90%84%E5%90%8D%E8%AF%8D%E8%A7%A3%E9%87%8A/"><span>区块链中各名词解释</span><i class="fa fa-chevron-right"></i></a></div></nav></div></div><footer class="footer-bg" style="background-image: url(/img/blog-bg.jpg)"><div class="layout" id="footer"><div class="copyright">&copy;2020 - 2023 By 晟松</div><div class="framework-info"><span>驱动 - </span><a target="_blank" rel="noopener" href="http://hexo.io"><span>Hexo</span></a><span class="footer-separator">|</span><span>主题 - </span><a target="_blank" rel="noopener" href="https://github.com/Molunerfinn/hexo-theme-melody"><span>Melody</span></a></div><div class="icp"><a target="_blank" rel="noopener" href="http://www.beian.miit.gov.cn/"><span>湘ICP备2020021729号</span></a></div><div class="busuanzi"><script async src="//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js"></script><span id="busuanzi_container_page_pv"><i class="fa fa-file"></i><span id="busuanzi_value_page_pv"></span><span></span></span></div></div></footer><i class="fa fa-arrow-up" id="go-up" aria-hidden="true"></i><script src="https://cdn.jsdelivr.net/npm/animejs@latest/anime.min.js"></script><script src="https://cdn.jsdelivr.net/npm/jquery@latest/dist/jquery.min.js"></script><script src="https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@latest/dist/jquery.fancybox.min.js"></script><script src="https://cdn.jsdelivr.net/npm/velocity-animate@latest/velocity.min.js"></script><script src="https://cdn.jsdelivr.net/npm/velocity-ui-pack@latest/velocity.ui.min.js"></script><script src="/js/utils.js?version=1.9.0"></script><script src="/js/fancybox.js?version=1.9.0"></script><script src="/js/sidebar.js?version=1.9.0"></script><script src="/js/copy.js?version=1.9.0"></script><script src="/js/fireworks.js?version=1.9.0"></script><script src="/js/transition.js?version=1.9.0"></script><script src="/js/scroll.js?version=1.9.0"></script><script src="/js/head.js?version=1.9.0"></script><script src="/js/search/local-search.js"></script><script>if(/Android|webOS|iPhone|iPod|iPad|BlackBerry/i.test(navigator.userAgent)) {
  $('#nav').addClass('is-mobile')
  $('footer').addClass('is-mobile')
  $('#top-container').addClass('is-mobile')
}</script><div class="search-dialog" id="local-search"><div class="search-dialog__title" id="local-search-title">本地搜索</div><div id="local-input-panel"><div id="local-search-input"><div class="local-search-box"><input class="local-search-box--input" placeholder="搜索文章"></div></div></div><hr><div id="local-search-results"><div id="local-hits"></div><div id="local-stats"><div class="local-search-stats__hr" id="hr"><span>由</span> <a target="_blank" rel="noopener" href="https://github.com/wzpan/hexo-generator-search" style="color:#49B1F5;">hexo-generator-search</a>
 <span>提供支持</span></div></div></div><span class="search-close-button"><i class="fa fa-times"></i></span></div><div class="search-mask"></div></body></html>